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NAME 

yacc - yet artother coxnpiler-compii., 
SYNOPSIS 

/usr/ccs/bin/yacc f -dl^vw i , ^ 



Y^ft yacc command converfcs ^ ^ ^ 

precedence rules are used to break aJbi^SJfes"'' «P^°"i'<« 

JLV.?" co^iled by the c co„^nor 

^^?Jn^* i^J^ical analj«""*i:_ T^^'' P*°Sr^^ must be loaded 
»aln() and yyerroro, an er«r J^Hi -^^^'''^' " as 

useful for creating le.ie.l analyz;r3\%ab!e '^1 yl'^T''' " 
OPTIONS ^ ^ • 

The following options are supported: 

-b -□f_Di_Dl_De qp_D,_o,_o, 

O .Of_0i_n._Oe_^_g,_,,_,,_,,_^ ^^^^^^^ 

output files. The eon* , 

tively. - - _ — *'_^^_»-J« 

;PP":ha\^^ a^^r;^e"-t\f --e- 

than y.tab.c to ..ces^"fbe\\°^:/:-«/Ues other 

nS^'o'ntaiT\;5%-Jj/---f in will 
Should only be uLd a?ter ?he'":^'' 'P^^^^" 
associated actions are'Sly'SLuJSr'^ ^'^^ 

' ~'^~°'"^^^?elS'-of /iir^^ Of your choice 

specify: ■^'i/yaccpar . For example, you 
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-P _Os_ay^C]m_Dp_Dr Qe_Df_Oi_0x 

.□,.D,.0S_5= ^ ^^^^^^ 

external names prpduced by yacc Th* 

yacc . The names 
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t^ser Commands 



yaccd) 



_Dh_o._Dr *nd the v.rl«ble3 _Dy_Oy_S[^Dv^Da_ai, _0y Oy Oc 

and J}y Oy Dd Qe Db [Tu Ha ^-k , 

the syn>boliciSd I«^«f2: "^'"-^ 

default names only as a „„i-f^- ? "^^'^^ theit 
local na«a3 may also be a??ent^rK^ convenience.) 
however, the -J option dJ5! ^ "P option; 
symbols generaLd'^S^Jacc ^"^^^ 

Bion Of yacc builj th^ ^° ''"^^ *"^*t ver- 

-efaultJ^wxite^rvS^ifi^-,:-^^^^^^^ 

YYDEBUG , a pJeJJLJ^f^ /\ T'^^^ '^^^ ^°"trol of 
non-zero value " YYDEBUG ha^ a 

included. If it^'valJa L code is 

program prodSSd lUi^olV Z ' SSSf ^ 
code will be smaller and sli^StlJ^JJ^:^.^^^"^^^"? 

L1:^a?L^'fof J2c"' ^"^^ version 

des?"ptio?%f^ii^ y.output, which contains a 

conflict.-. bTK- rth%-:^r 

OPERANDS 

The following operand required: 
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EXAMPLES 

E-^pu 1, y^i^^ y^^^ ^^^^^ 

to the vactf* 

examples cc y.tab.c -ly 
Both the lex library anH 

access the yacc mJ^^/"^ ^''^ V^^^ Ubrary contain m.in. To 



for 
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yacc(l) 

The historical vacc hk-. 4 

functions that are n«^fif' contained two simmo 

#ix>clucle <locale*h> 
int main (void) 

extern int yyparse(}; 
setlocal^ (LC_ALL, "") ; 



} 



return (0); 

^include <stdio.h> 

int yyerror (const ch^r -msg) 
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) 



(void) fptintf (stderr. "%s\n" «.= ^ 
return (0); "-"^^-^r es\n , msg); 



E^fVIRONMENT VARIABLES 

r^^^^i^l^^^^^^^^^^ following environment 

LC_MESSAGES, and NLsSth. of yacc : LC_CTirPE, 

single character quoted ter^S?^^ ' ^'''^^^ "«y only 

yylexo to return Hid; c^lftctll y^<^^ ^^plcts 

e>n6-token syniboXs. ^^aracter (wchar_t) value for these 

EXIT STATUS 

The following exit values are returned: 



0 

>o 



FILES 



Successful Coh4>letion, 
An error occurred. 



y. output state transitions of the generated parser 
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yacc(l) 



y-tab.c source code of the generated parser 
y.tab.h header file for the generated parser 

y^cc^acts ten^orary file 
yacc. debug 

temporary file 
yacc.tii^j temporary file 

yaccpar parser prototype for c programs 
ATTRIBUTES 



r 



^ATTRIBUTE TYPE" 



AXTHIBUTE VALUE 
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I Availability ^ — ^ r°lumjbt^^r~ — — 

" ^ ' □ . 

SEE ALSO 

cc(lB), lex(i), attributes (5), environ (5) 

^ -0 Wo_0,_D._0._^^CM_Di_On_0, _0U_0t,Di_ai_Di_0t_0i_Oe^^3 

DIAGNOSTICS 

rep\;t":S"on' ^hift^reduce conflicts is 

report is found'i\ th'^J o^tput^lnr^^SIiii: n'^''^'' 
rules are not reachable from t^L t i ^^"^^a^^^V' if eome 
is also reported. ^yiobol, this instance 

NOTES 

Because file names ar6 fircxA i. 

be active in a .ieefSift^LVitTSieS; 
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lex(l) 

NAME 

lex - gene^rate programs for lexical tasks 
SYNOPSIS 

DESCRIPTION 

interface to yacc The 5 Dro«r^;. ^ ^^^^ ^« ""'^ 
source code ind cinSL to ?he ?so''r^.'T'f ^''^ ^^'^ 
lex utility writes thrprooram II I ^'''^"^^d- "dually, the 
lex.yy.c; the state of ?hls fi i ! "^" ^^^^^ 
exits with a non-zero exi% . Unspecified if 



OPTIONS 

The following options are supported: 

Indicate C-language action (default option) . 



of type unsigned chirt) ""^ ' ^^''^^f 

fi-d in the le/ ioS^cJ cSSe ^'^V^P^C.i- 
not specified, then -n iri^ned ' ~" 

Kst:aS':f'^j:^!^?L ^^^^^^^ ^° ^^-^-^ --p-^ 

erroJ/ (S^'^Le' ^^f^^^ics to the standard 

under thfS:.di%^ oS?SS2 if 111^'^ lUtl 

Bizes are SDecififvrJ -ir. t^u i ■'•^^•J If table 
if th^ -n . source code, and 

it Che -n option is not specified rh^ ' . 

may be enabled. sp^ciried, the -v option 

option, yytextt] is of typ= Sa^lhy 
-V Print out version inforrt^tion on standard error. 

!efyyrV^"'°" inforn^tlon to output file' 

pS;r;St ^Lsio^L/^^- .^^^ option does iot 

print out version information and is the default. 



-w 
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lex(l) 

The fcllowing operand is supported: 

idl^'^lTt.lL^^^^^^^^ than one such 

to produce a single f ''^ concatenated 

operands are .ploLfdd^ orTt'll'i, " '^'^ '^^^ 
/ the standard input will be usL operand is 

OUTPUT 
Stdout 

l^.^^^ -t option is specified ty,^ ^ 

" - --V?f staUVo^,,^^ 

ing'''*«,;^4Pj'**2^i^ JJ^^ified inforxaational, error and warn- 
xnput Win .e written^^hrs%anSr:Lo1/^'' -ur^e^^Se 
If the -t option is not specified: 

Informational error and wariil«« 

the cont^xite of lex sourcJ 2^2! ."'^"^ffes concerning 
to either the .tandar^u^^r^ SaS^L^^.^^^^- 

Jpocm^dV'i't:' 'umtittf ^^p^^- i« -t 

ftandard error. These sta^isf-J " written to 

*f table sizes are SDerr^l" 5 generated 
Definitions in le" ?ecUon V^'''' ' * operatL in tSe 
"ON), - long a. the^!n°%°?, nS™?,,^?--^- 
output Files 

A text file containing c sourer 

lex.yy.c, or to thi sta«H ^ """^^ "^^^ written to 

present. "andard output if the ^t ip^on is 

EXTENDED DESCRIPTION 

S^e\Ta%^^^:,™ code, which is a table 

«<>m of c program tAZlntT """^P^^^^ing actions in tile 



2. 
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strings tnat match the given expressions. 
When an expression is ,„atched, these actions will occur: 

Character array or a PoJ^t^J^tS'a^charlSi?^^^^ ^^^^^"^^ 
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lex(l) 

exSJciSy 'JelecS3''i:;:a 'lu ^^^^ 
'^^n.at^hinf rStigt'^' -□y_0y,01.De_Dn_Og is ... the length of the 

During pattern matching, lex searches .-4- * ^ 
for the singlft lonoest no^^f^ff °^ pattetna 

match the same numieJ^S? chariest T""""' ^^^^.^^^^^ that 
Will be chosen. cnaracters, the rule given first 

The general format of lex source iss 

~SE'^^-nf-S^-°^-°^-°*^-°i Dn OS %% 
_UR_Ou 01 0^_0s %% - - - 

_0U_Ds_ae2Qr _DS_Du_Db_Dr_Oo Ou Ot_Oi_Dn Oo Ds 
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PAGE 



or Within 

_DR_Ou_ai_De sectiorbeforr ' f*" ""^^ beginning of th^ 

to lex.y?.c- after tL declarar""^^" specifil^ will be written 

gjlex function and b.Sre ?he first Une°o'f'";"''"= ^'^^ 

Thus, user variables local to vZlll ^^"\°f_^code in yylex. 

The action taken hv lex urK*.r. ^ 

niag with a blaL cJar^Ster SrS^hf^^r'^^ ^^^in- 
Unes appearing in the 5r Jj^'arn^ S^*" V-*""^ deUKdter 
"•ore tules is undefined? Th«-^7° ''"^^ ^fter one or 

-ult in orthryyr:/rct\r? 

t>efinitions in lex 

lines and not beginning wi?h 2 ki u^*^"®'* betwt^n and %) 
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is: 



.0n_0a_Drn_0e -0^_Du,Db_05_Dt_Oi_0t_0u_ot^0e 

tL^i^c^stSaJrdf'tL^re.Sfis'': f^^^-^-^nts for identifiers In 
,^0t_0i_ot^Ou^,,_,. -i:~^^^^^ ^ 

within a brac,.t expression or witS^S diibl^^ot^:? 

J^'^perL'Sj'si^;? cSaraJter!n'd°?'i?'^^ ^^"^ ^-^^""^'^5 v,ith 
word beginning SJih eUhet % s diJ°"^^ alpha?umeri2 
conditions. Anv H„» k ■ ? defines a set of starh 
beginning with^rtier\^:rrdL"''^ * * 4 a ^"d 

^tart conditions. Wh^ tL generated °' -K-iu.ive 

ftAte, patterns with no state scanner is in a fts 

ia a %x state, such P^^teJjs wnrio"b/''i-''" ^^^^i^^'- 
the line, after the first word ^f^^"^^""^- The rest of 

K^re blank-character-sepawSd to be one or 

Start condition na.es a:rc";:L::;rin''\h:"r '^-^^^^-^ 

uctea xn the way as 
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described in ReguiL e^prSsJ^rjn JL'"' " ""^"^^ " 

Implfcitt^htations accept either nf t-u r 

..elusive a.=i.„yoL i„i^: »'£ii;rtSi^°s''L^'",eSi^' 

%array is the default ir • 

^ke an external refererxc/to Dy S Sx St -^^''-^^ ^'"^ 

the form: _"y_'Jy_Ue_nx_at xs with a declaration of 



extern char ^□y_Dy_Dt_0e_03c_^Dt [ ] 



extern char ••_Oy_Oy_0t_De_Dxj)t; 



j-iiuci^xiax table sizes. The 
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lex{l) 



declarations are shovm in 

snovm in the following table. 

Table size Declaration in lex 



Declaration 
%p_Dn 
%n_Dn 
%a _Dn 
%e_Dn 
%k On 
%o*0n 



Description*" 
Number of positions 
Number of states 
Number of transitions 
Number of parse tree nodes 

sJS^of^^^^"*'!^ character clas.es 
Size of the output array 



Default 

2500 

SOO 

2000 

1000 

10000 

3000 
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pLr^n-?-.L' ^ , ^sv--" ---- 

handle only ASCII cSract"i!' generated p^„g„„, 

mtched string. Sith' this Lti^f -^J^Y.Ot_0._pa in the 

unput(_ac), and output ( Dc) sh^uJd k"*^"" InputoT 

same way as with the regular ASCn ^fx I/O in the 

"e available with the -e ontton , ^ ' Variables 
behave the s^me as yytext and yywleng. which 

option. ^^''^''^ ^""^ yyleng would undfer the -w 



Wh^n the -w option is used, yytext is „f ^v, . 
and yyieng gives the total nLJ V"^ ^^P^ "^^^'^ t[l 
= , , , "'^^^ °^ -.ac^Dh_Da_Dr_Ba_Oc Ot Dt Os i 
matched string, if you suddIv v.... . 



accept EUC- characters S tSe fo™""; "'"^^ « 

(wchar_t) . This allows I difLrf.f^- ^'^'^^ character 

program and the lex internals; S SeSJJrfo;^^ 

» >-u expeaite some programs. 

Rules in lex 

coluS^'^^ij^i^^ regu^L^'^x^ ^"'''^ '^i'=»* 

contains actions (C TooramTr^^rf ^^^ht column 

the expressions are JecoJ^zf"^^''^'' executed wS 

.OE_OR_DK _Da.Oc_at,ai^a._o„_o,_,,_,^ _ 

. fep^:Stidi?:i"orgrsf io''^ r"^- ^ - -^i 

«o The entire expression appears within double-guotes 

The blan. characters appear within double-c^otes or 

SunOS 5.7 T^^i- 
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Use 2: Commands 



square brackets. 
+0q Each blank character 



is preceded by a backslash ch^r- 
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acter. 

User Subroutines in lex 

Regular Expressions in lex 

Any string enclosed in double-auotes will 
ITl^i:^ l''^ Characters withinli: n^-qurie 
as themselves, except that backslash escapes 
nSef A^^^r\ i" l""^ following tabl^^are :::^;! 

r^hrcj^srs;.^^^^^^^^^ 

<.Os^Dt_Da Dt.Oe.Dl, ^□3_Dt_Qa_Ot_0e_D2 , ...>□, 

JSe ''pfoirL^'Tr"'^" ^^'^^^J "hen 

i start conditions 

_03_at_na_0t_De, ^D3_Dt_Da_Dt_ae_01?%nd .o forth; f 

thf ^^otrLnr t"^'"' ^" exception to 

tne typographical conventions of the rest of this 

it irfonlwin^^'^"""'' "itched only if 

It IS followed by an occurrence of regular eXDres- 

beoinniHa nv Portion of _Dr matchei the ^ 

exSestJL Ln?^; is unspecified. The Dr 

o^ Se S t^iith^r trailing context " 

InaltV " T^th^K^^^^* . <>P"-to-; cannot 
nor trail <««tch-begxnning-of-line) operator, 
on ^ context, nor the $ operator, ^hat is 

onit >^^9ular expression, and the - operator 

eSre«J?L ""t T^t beginning of Lch a^ 

tr^f?^« further restriction is that the 

arouS^:-^!!^^'''' operator / < slash) cannot be 
grouped within parentheses. 
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lex(l) 



ing the 
11 be treated 



The _Os_Du_Ob_Ds_^Dt_Di_Dt_Du □t_Oi vilue wi 

eJc£:e:"rS'taJSr ^''^^"'-n " " it were" " 
occur if ( Sn Oa S Sm"' "° '^"itution will 
or Within 5Sk?er^o?ei. °"'' ^ ^'^^'^^^ exj,ressio„ 

Within an ere, a backslash character (\\, \a \h v. k 
be recognized. qvences m the fallowing table will 

A literal newline charactet f-«T,„«4. 

escape sequence \n c^S be useHo rf^'^ ^he 
acter, A newline character cfn?„^ k''^^''^^^"^ ^ newline char-^ 
operator. "^^racter cannot be matched by a period 

Escape Sequences in lex 



I 



I 



in lex 

Escape Sequence Description 



Escape Sequences 



Meaning 



A backslaah character fol- The characte 



I \_Od_Di_Dg_Di_ot as 

r whc>6e encod- 1 ~ 

^h-'l ' ^°-<^ ^he longest sequence ing i. represented by 

git I or three octal- 

ytel' digit characters (01234567). 

ti-l' Ifall of the digits are 0, 

^P^'l representation of pj.., concatenated esc 

pe, I NUL character), 

fori ' behavior is undefined. 



one-/ two* or three-di 
octal integer. Multi-b 
characters require raul 



\x_ad_^Oi_Dg_oi_Dt^Dg 



the sequences of this ty 
including the leading \ 
each byte. 

A backslash character fd- The characte 
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t Whose encod- | 
the I 



nged 



\ Oc 



01 



lowed by the longest sequence ing is represented by 

Of hexadec4^^i.^igit charac- hexadecimal integer. 

ters {01234567abc:defABCDEF) . 

If all of the digits are 0, 

(that is, representation of 

the NUL character), the 

hcihavior is undefined. 

A baclcslash character fol- The character c, uncha 
lowed by any character not 
described in this table. 
(W, \a, \b, \f, \en, \r, \t. 
\v). 



to low. ^ ^^"^ following table, from high 
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Note: 



Slt^SJl^S^S^t^rnjt't."^'^ ""^"^ ^° -^^v 

and':nS:;ing'not:ti:n3'^S;S'^°"' '^f^'^'^^ """^^^^^ 
table because Of hh^ i^^*" omitted from the 
described in slatlnl K^""'^"^ restrictions 

the beginni;g'or%nSg°o^ Tl^'"' ^^^""^ 

I ^ ""^ ■ 

I in lex 



ERE P^recedence 
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k.O._ot J>^OylA%%°k%l'^-f.-°\~'^,-r'^^^^^^^ W Ob 0, DC □ 

I _0q_0u_0o^Dt_ai_on Qg 

i 09_0>^JJoJDuJ3p Qi On Og 
' - - _ 3 

Om Oe) ' -^-°*-°f_ai_.l3n_0i_0t Di 

inn- ' ~ ~ ~ LC'n_Da_ 

01_Di_Gc_Oa_Dt!Qi^&°Ss°"-%°i^?^ Dr OR OE Del Du V 

(_0m,_inT°'-°'^-°^-°^-°'^-°--0*-01 .□e_Ox_cJ_o;_De Os 01 Oo On 

I _Oa^oi Dt_a6_or_,cto oi 



01 



The ERE anchoring operators «nrf ^ 

table. With i4 ^^ffj ixpJ^JJLf «PP"^ i« the 
restricted in their use: tL"^f^"f?"*'' opetators are 

the beginning of an entire f""' ^^^^ ""d at 
operator only%t the 2nd ^he InTt t'' ^^P^^io". «»nd the $ 
regular expression. Thul^ fjf " ''^f^^ ^'^'^"^ 
rabc) I (def?) is undefined- it .f^ . ex^le, the pattern 
separate rules, one Sh the L^*? ^"^"^^^^ written as two 
with def$, whi^h share a c^L^n^^cL'' expression *abc and one 
action (see below) i? thHatte™"'' ""^^ ""^^ ^P^'^i^l • 
- would ^tch either of ab: inil\Tiri:tX\^^^^^^^ 

alWdX^S^^^^^ ^^J-^ -horing is not 

of embedded anchoring SouJd .^'^J^'"^'^^^'^""' ' ^n example 
foo($) to match Lo S^en it exf^f P«'=t"'^« «uch as 
This functionality can S oJtainid * corplete word, 

features? ' ^ obtained using existing lex 

''£00/ 1 \n]| 

" fooVi \n] .ound foo as a separate w.rd V 

Npt^ also that S i « » ^ 

equivalent to /'J and afsu^iJ trailing context (it is 

SunOS 5.7 T=,o+- u 
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reguS'^'^S^LS^'Ld'rr'r ^""-'^-^ between lex 
whire in Sis d^JJ^ent For^S^l^f appearing else^ 
Or/ Ox, the string M.;.^^ '^^^^^ expressions of the form 
arisi wLn thf ftginSiia of ' n""^ " e^***^* returned; confusion may 

the input A^abcc, □y'afS?"a!^o^''^r '^'^'^ 
this match. But iiJin th^-SaS^Ir V"^'^ contain the string aaab on 
input xxxy, the token nT t^ expression xVxy *nd the 

a«plementations because xxx S^L^'^*" by some 

result is unspecified ? trailing context, so thi 

rule m^tches^JSe iex; I lit" ff^ were ab/bc, however, the 

. In this letter caJe ?he " ^"^i^wed by the text be 

the beginning of loT/ H -tend into 

Actions in lex 

program fragment can con?SiS oL «^ ' described below; the 
can also include speciarjc?ioJs ^^^"""^ ^ statements, and 
a valid action; aSy sttJna ?n* H ^ statement ; is 

niatches the ^atSL poSion 2f \ ^^^•^-'^ inP«t that 
ignored or skipped. Sowever ?hf.r ^ '"^^ effectively 
valid, and the action f^x % ^^^"''^ ""t 
undefined. ^^^^^ ^"^h a condition is 

s5:cSriSr:^ircfreSe:rr"' '"^^-^^^^ statements and 
in braces: several lines if enclosed 

ERE <one or more blanks> { program statement 
program statement ) 

string to the outpu? BecauK tS^'^dSa^lt'b'i: 

gram generated by lex is to rLn " behavior of a pro- 
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generates a c nt^rs 

output unchanged. ^""^ ^^^^^ the input to the 
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Four special actions are available, 
I ECHO; REJECT; BE61H 



I 



ECHO; 



REJECT; 



string _Dy_ay_at_De_Dx_at on the 



BEGIN The action 



other three actions 7 ^^^^ Unlike the 

braces or be sS;«i' ^'^''^ enclosed in 

3P«ci.i.d\i^:e/wTt?^ir;t^Tj-^^^^^ ^« 

Write the contents of the 
output. 

p;:i^^s?ynVi;^jh^"in\-^-s^^c^— ^-^^ * 

choic. after t^n^^^ntluirtri" ^^^^'^^ 
the same inout- t^,, executed for 

•"atcherand executed '"""^Pi^ "les be 

lapping inpurstSjg^'^^rL^?" '^''"^ " 
ul^r expressions xy^ ^nd L S ;>,^^''- " "9" 
usually only the , ^^^P^^^ Xyz, 

match. The next a?t™n?^i expression xyz woGld 

both this rule and Jhe ^^1/"" f:^^! ^^^^ ' 
The REJECT action mav b^ fj?"^** executed, 
fashion that flow Sf control ^^^^"**'=* « 
after it, as if ±1 «f '^^^^ continue 
another pirt of'yyiex^\!f ^^*^«"^to a goto to 

result in somewhIr!a;ger and l" "^^^"^ 
>- J-arger and slower scanners. 



BEGIN _an_De_Ow_Os^Dt_Qa_at Qe; 
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viously as a start condition in the Definitions in 
lex section, the results are unspecified. The 
initial state is indicated by the digit 0 or the 
token INITIAL. 

The functions or macros described below are accessible to 

!ih^^>,«''''?K ^"^l"**^'^^. the lex input. It is unspecified 

whether they appear m the C code output of lex , or are 
accessible only through the -1 1 operand to c89 or cc (the 
lex library) . 

int yylex(void) 

Performs lexical analysis on the input; this is 
the primary function generated by the lex 
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Utility. The function returns zero when the end of 
input is reached; otherwise it returns non-zero 
values (tokens) determined by the actions that are 
selected. 

int yymore (void) 

When called, indicates that when the next input 

string is recognized, it is to be appended to the 

^h^r? -ay_0y_at_De_0x_C3t rather than replacing it; 

the value in _Dy_Oy_Dl_De_Dn_ng is adjusted accordingly. 

int_Qy_Oy_Ql_Qe_Os_Ds (_ai_Dn_Dt n) 

f!™^"'.. iliitial characters in Oy Dy Dt De Ox Dt, MUL- 

terminated, and treats the remaining chiraZtl^s Is " " 

5^ ^^^'^ "^'"^^ the value in Dy Dy 01 De On Og is 

adjusted accordingly. - -y"-'-"i 

int input (void) 

Returns the next character from the input, or zero 

on end-of-file. It obtains input from the stream 

= ^^7°^-°^-?^-°"' Although possibly via an intermedi- 

^f?*.o^ scanning has begun, the 

?Jf i ""^ the value of „Dy_Dy_0i^0n is undefined. 

° " removed from the input 

stream of the scanner without any processing by 
the scanner. ^ jr 



int unputdnt Dc) 
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Returns the charactAK n 

matched, fh^result of Su n^^Si^n'^^n -xprieslon is 

acters than have been inpi^'il^lJn^ig^J^H^^ ''^^ 
The following functions apoear ««i 

accessible through ?L ?l library 

^edefinea by a Po?tablS appiL^L"? '^"^ therefore be 

int yywrap{void) 

yjl«< to continue pr;;e"iJ^\;?S"""™ r^piite. 
of Input, then the fpoflSL, '""'"'t sourco 
tlon ys™„p, which S^cJlSr 22,;"°''"'' ' 

int »"<i»J O^^r 0,.0c. ch„ ..o..o._o, 
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S:t^%^;r;; '^^^"^^^^^^^^^ ^-o two u^ts i^ 

fxned by a portable aJpUcatio;.'"''' "^"^ "^i^^ly "ede- 



USAGE 



nS\SLi?if i/s' B-^^irir^hiL p'"r-^ «-"c 

y-^" witn the prefix yy or YY. 
Portable applications are warned • 

section, an ERE without fn 5^^^ ^" RuUti . in lex 

need not be detected a^e«on;ous h''^^' acceptablS, tut 

concerned, a conton ^tu S .""^ lexical enalysi/" 

»ce the he,i.„i„, o. , ^°nf iTS^,' e c'o^J? 

-.i.x «ii„y i. int..„e„on.ai.ed 



in its 
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treatmisnt pf regular expressions in the lex source code or 
generated lexical analyzer. It would seem desirable to have 
^ analyzer interpret the regular expressions giv^n 
tld J:^''^ ^^"''f® according to the enviromnent specified 
when the lexical analyzer is executed, but this ia not poa- 
eible wi.th the current lex technology. Furthermore, the 
very nature of the lexical analyzers produced by lex must 
be closely tied to the lexical requirements of the input 
language being described, which will frequently be locale- 
epecific anyway. (Tor example, writing an analyzer that is 
used for French text will not automatically be useful for 
processing other languages.) 



EXAMPLES 

Exartplfe 1; Using lex 

The following is an example of a lex program that imple- 
ments a 4:u4im^ntary scanner for a Pascal-like syntax: 

%{ 

rin^^l'J^t^?^''^ ^^'^ ^'^'^^ 

LcHl'S^^^^^ .t.in below V 

%) 

DIGIT (0*9] 

ID [a-z] (a-20-91* 

%% 

{DIGIT) + J 

printf("An integer: %s (%d)\n«, yytext, 
^toi(yytext)); 

SunOS 5*7 Last change: 22 Aug 1997 12 



User Co7iQiiaan<l$ 



lex(l) 



) 

{DIGIT)+", "{DIGIT}* ( 



printfC'A float: %s (%g)\n", yytext, 

atof (yytext) ) ; 

) 



if I thfeh I begin I end | piro<-edure I function { 



printf{"A keyword: %3\n", yytext); 
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(ID) 

" + " I "-"I •»*" I M/ll 

[ \t\n]+ 



princf(-«An identifi«. %s\n", yytext) , 
printf("Aft operator: %s\u\ yytext); 
/* eat up one-line commftnts */ 
/* eat up white space */ 

Printf( "Unrecognised character:^ %s\n", yytext). 



int raaindnt argc, char *argv[]) 

ITTr^cTir ^* ^''^P P-9«m name V 

yyin « fopen(ai:gv[0], "r") ; 

else 

yyin « stdin; 
j yylexO; 

ENVIRONMENT VARIABLES 

v^ri^r^rSt'^^Je'^rlJ'''"^ ^^^^-^^^ environment 

EXIT STATUS 

The following exit values are returned: 
^ Successful completion. 

^ ^rxor occurred. 

ATTRIBUTES 
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ATTRIBUTE TYPE" 



I 



Availability" 



_0I, 

I SUNWbtool 
01 



ATTRIBUTE VALUE" 



SEE ALSO 

yacc(l), attributeMS), environ(5), t.g.x(5) 



NOTES 



□ I 



(euTm^" :;e^M^^^^^^ in a 

For exawpie: P^^^ram must cJefine the _EXTERN_C_ macro. 



exawplei CC -D_EXTERN_C_ 



file 
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